<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta http-equiv="Content-Language" content="zh-CN"><title>systemd-cgtop
  中文手册 [金步国]</title><style>
@font-face { font-family: "JinBuGuoWebMono"; src: url("http://www.jinbuguo.com/d/mono.ttf") format("truetype"); }
* { font-family: "JinBuGuoWebMono", "Ubuntu Mono", "Consolas", "Menlo", monospace; }
body { margin:10px; }
h1 { text-align:center; background:#ddd; }
h2#auth_name { text-align:center; margin: 10px 5%; }

    a.headerlink {
      color: #c60f0f;
      font-size: 0.8em;
      padding: 0 4px 0 4px;
      text-decoration: none;
      visibility: hidden;
    }

    a.headerlink:hover {
      background-color: #c60f0f;
      color: white;
    }

    h1:hover > a.headerlink, h2:hover > a.headerlink, h3:hover > a.headerlink, dt:hover > a.headerlink {
      visibility: visible;
    }
</style><script> var _hmt = _hmt || []; (function() { var hm = document.createElement("script"); hm.src = "https://hm.baidu.com/hm.js?d286c55b63a3c54a1e43d10d4c203e75"; var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(hm, s); })(); </script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><h1>systemd-cgtop 中文手册</h1><h2 id="auth_name">译者：<strong><a href="http://www.jinbuguo.com/">金步国</a></strong></h2><hr><h3>版权声明</h3><p>本文译者是一位开源理念的坚定支持者，所以本文虽然不是软件，但是遵照开源的精神发布。</p><ul><li>无担保：本文译者不保证译文内容准确无误，亦不承担任何由于使用此文档所导致的损失。</li><li>自由使用：任何人都可以自由的<u>阅读/链接/打印</u>此文档，无需任何附加条件。</li><li>名誉权：任何人都可以自由的<u>转载/引用/再创作</u>此文档，但必须保留译者署名并注明出处。</li></ul><h3>其他作品</h3><p>本文译者十分愿意与他人分享劳动成果，如果你对我的其他翻译作品或者技术文章有兴趣，可以在如下位置查看现有的作品集：</p><ul><li><a href="http://www.jinbuguo.com/">金步国作品集</a> [ <a href="http://www.jinbuguo.com/">http://www.jinbuguo.com/</a> ]</li></ul><h3>联系方式</h3><p>由于译者水平有限，因此不能保证译文内容准确无误。如果你发现了译文中的错误(哪怕是错别字也好)，请来信指出，任何提高译文质量的建议我都将虚心接纳。</p><ul><li>Email(QQ)：70171448在QQ邮箱</li></ul><hr><a href="systemd.index.html">手册索引</a> ·
  <a href="systemd.directives.html">指令索引</a><span style="float:right">systemd-241</span><hr><div class="refentry"><a name="systemd-cgtop"></a><div class="titlepage"></div><div class="refnamediv"><h2>名称</h2><p>systemd-cgtop — 按照资源使用率从高到低的顺序显示控制组</p></div><div class="refsynopsisdiv"><h2>大纲</h2><div class="cmdsynopsis"><p><code class="command">systemd-cgtop</code>  [OPTIONS...] [GROUP]</p></div></div><div class="refsect1"><a name="id-1.5"></a><h2 id="描述">描述<a class="headerlink" title="Permalink to this headline" href="systemd-cgtop.html#%E6%8F%8F%E8%BF%B0">¶</a></h2><p><span class="command"><strong>systemd-cgtop</strong></span>
    按照资源使用率(CPU,内存,磁盘吞吐率)从高到低的顺序显示系统中的控制组(Control Group)。
    显示的列表每个一段时间进行一次刷新(默认一秒刷新一次)，
    输出的列表风格类似于
    <a href="http://man7.org/linux/man-pages/man1/top.1.html"><span class="citerefentry"><span class="refentrytitle">top</span>(1)</span></a> 。
    如果明确指定了  [GROUP] 参数(控制组路径)，
    那么将仅显示指定控制组路径下的单元。</p><p>如果 <span class="command"><strong>systemd-cgtop</strong></span> 并未连接到某个终端(TTY)，
    那么将不会显示列标题，并且在输出列表之后立即退出(也就是不会重复刷新)。
    不过如果明确设置了 <code class="varname">--iterations=</code> 选项，那么还是会在刷新指定的次数之后再退出。
    此模式经常用于脚本环境。</p><p>资源占用仅根据控制组的对应的层次进行统计。
    具体就是，
    CPU占用仅根据控制组的 "<code class="literal">cpuacct</code>" 层次进行统计。
    内存占用仅根据控制组的 "<code class="literal">memory</code>" 层次进行统计。
    磁盘I/O占用仅根据控制组的 "<code class="literal">blkio</code>" 层次进行统计。
    如果需要针对特定的单元监视这些资源的占用状况，可以将
    <code class="varname">CPUAccounting=1</code>,
    <code class="varname">MemoryAccounting=1</code>,
    <code class="varname">BlockIOAccounting=1</code>
    添加到特定的单元文件中。详见
    <a href="systemd.resource-control.html#"><span class="citerefentry"><span class="refentrytitle">systemd.resource-control</span>(5)</span></a>
    手册。</p><p>CPU占用值介于 0 与 100*CPU总核数 之间。
    例如，在一个拥有8颗CPU核心的系统上，
    CPU占用值将会介于 0% 与 800% 之间。
    CPU总核数可以从 "<code class="literal">/proc/cpuinfo</code>" 中获取。</p><p>再次强调，除非在单元文件中设置了
    "<code class="literal">CPUAccounting=1</code>",
    "<code class="literal">MemoryAccounting=1</code>",
    "<code class="literal">BlockIOAccounting=1</code>" 指令，
    否则不会针对单个服务统计资源占用，
    并且也不会在
    <span class="command"><strong>systemd-cgtop</strong></span> 中显示详细的资源占用数据。</p></div><div class="refsect1"><a name="id-1.6"></a><h2 id="选项(OPTIONS)">选项(OPTIONS)<a class="headerlink" title="Permalink to this headline" href="systemd-cgtop.html#%E9%80%89%E9%A1%B9(OPTIONS)">¶</a></h2><p>可以识别的选项如下：</p><div class="variablelist"><dl class="variablelist"><dt id="-p"><span class="term"><code class="option">-p</code>, </span><span class="term"><code class="option">--order=path</code></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#-p">¶</a></dt><dd><p>按照控制组的路径
        排序</p></dd><dt id="-t"><span class="term"><code class="option">-t</code>, </span><span class="term"><code class="option">--order=tasks</code></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#-t">¶</a></dt><dd><p>按照控制组内的任务/进程数量排序</p></dd><dt id="-c"><span class="term"><code class="option">-c</code>, </span><span class="term"><code class="option">--order=cpu</code></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#-c">¶</a></dt><dd><p>按照CPU占用率排序</p></dd><dt id="-m"><span class="term"><code class="option">-m</code>, </span><span class="term"><code class="option">--order=memory</code></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#-m">¶</a></dt><dd><p>按照内存使用量排序</p></dd><dt id="-i"><span class="term"><code class="option">-i</code>, </span><span class="term"><code class="option">--order=io</code></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#-i">¶</a></dt><dd><p>按照磁盘吞吐率排序</p></dd><dt id="-b"><span class="term"><code class="option">-b</code>, </span><span class="term"><code class="option">--batch</code></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#-b">¶</a></dt><dd><p>以"批量"模式运行。也就是，不接受任何输入，
        一直运行到
        <code class="option">--iterations=</code> 刷新次数结束或者运行中途被杀死。
        此模式可以用于将
        <span class="command"><strong>systemd-cgtop</strong></span> 的输出
        发送给另一个程序或写入某个文件。</p></dd><dt id="-r"><span class="term"><code class="option">-r</code>, </span><span class="term"><code class="option">--raw</code></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#-r">¶</a></dt><dd><p>将字节计数(内存占用与I/O度量)
        按照原始数值显示，
        而不是按照人类易读的方式显示。</p></dd><dt id="--cpu=percentage"><span class="term"><code class="option">--cpu=percentage</code>, </span><span class="term"><code class="option">--cpu=time</code></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#--cpu=percentage">¶</a></dt><dd><p>控制CPU占用
        是按照百分比显示还是按照总时长显示。
        默认是按照百分比显示。
        可以在运行时使用 <span class="keycap"><strong>%</strong></span> 按键切换显示方式。</p></dd><dt id="-P"><span class="term"><code class="option">-P</code></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#-P">¶</a></dt><dd><p>仅统计用户空间进程(也就是不统计内核任务)。
        默认是
        分别统计每一个内核线程与每一个用户空间线程。
        使用此选项之后，
        内核线程将会从统计中排除，
        并且每一个用户空间进程(无论内部包含了多少个线程)都仅作为一个整体进行统计。
        可以在运行时使用 <span class="keycap"><strong>P</strong></span> 按键切换统计方式。
        此选项不可与
        <code class="option">-k</code> 选项一起使用。</p></dd><dt id="-k"><span class="term"><code class="option">-k</code></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#-k">¶</a></dt><dd><p>仅统计用户空间进程与内核线程。
        默认是
        分别统计每一个内核线程与每一个用户空间线程。
        使用此选项之后，
        统计中将会包含内核线程，
        并且每一个用户空间进程(无论内部包含了多少个线程)都仅作为一个整体进行统计。
        可以在运行时使用 <span class="keycap"><strong>k</strong></span> 按键切换统计方式。
        此选项不可与
        <code class="option">-P</code> 选项一起使用。</p></dd><dt id="--recursive="><span class="term"><code class="option">--recursive=</code></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#--recursive=">¶</a></dt><dd><p>在统计控制组内的进程数量时，
        是否递归的包含所有子控制组内的进程。
        接受一个布尔值。
        默认值 "<code class="literal">yes</code>" 表示包含。
        而设为 "<code class="literal">no</code>" 则表示不包含。
        可以在运行时使用
         <span class="keycap"><strong>r</strong></span> 按键切换统计方式。
        注意，
        此选项仅影响控制组内的进程数量的统计(也就是使用了
        <code class="option">-P</code> 或 <code class="option">-k</code> 选项)，
        而不会影响对所有任务数量的统计
        (永远以递归方式统计)。</p></dd><dt id="-n"><span class="term"><code class="option">-n</code>, </span><span class="term"><code class="option">--iterations=</code></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#-n">¶</a></dt><dd><p>仅刷新指定的次数，
        然后退出。
        设为 0 表示无限刷新。</p></dd><dt id="-1"><span class="term"><code class="option">-1</code></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#-1">¶</a></dt><dd><p> <code class="option">--iterations=1</code> 的快捷方式</p></dd><dt id="-d"><span class="term"><code class="option">-d</code>, </span><span class="term"><code class="option">--delay=</code></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#-d">¶</a></dt><dd><p>指定每次刷新的时间间隔(默认单位是秒，但是也可以使用
        "<code class="literal">ms</code>", "<code class="literal">us</code>",
        "<code class="literal">min</code>" 单位后缀)。
        可以在运行时使用
        <span class="keycap"><strong>+</strong></span> 与 <span class="keycap"><strong>-</strong></span>
        按键调整此值。</p></dd><dt id="--depth="><span class="term"><code class="option">--depth=</code></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#--depth=">¶</a></dt><dd><p>设置
         <span class="command"><strong>systemd-cgtop</strong></span>
        遍历控制组层次树的最大深度。
        设为 0 表示仅监视根控制组，
        设为 1 表示仅监视第一层控制组，以此类推。
        默认值是 3 层。</p></dd><dt id="-M MACHINE"><span class="term"><code class="option">-M <em class="replaceable"><code>MACHINE</code></em></code>, </span><span class="term"><code class="option">--machine=<em class="replaceable"><code>MACHINE</code></em></code></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#-M%20MACHINE">¶</a></dt><dd><p>限制仅显示
        与 
        <em class="replaceable"><code>MACHINE</code></em> 容器对应的控制组。
        当明确指定了控制组路径的时候，不可以使用此选项。</p></dd><dt id="-h"><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#-h">¶</a></dt><dd><p><a name="help-text"></a>显示简短的帮助信息并退出。
    </p></dd><dt id="--version"><span class="term"><code class="option">--version</code></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#--version">¶</a></dt><dd><p><a name="version-text"></a>显示简短的版本信息并退出。</p></dd></dl></div></div><div class="refsect1"><a name="id-1.7"></a><h2 id="按键">按键<a class="headerlink" title="Permalink to this headline" href="systemd-cgtop.html#%E6%8C%89%E9%94%AE">¶</a></h2><p><span class="command"><strong>systemd-cgtop</strong></span> 是一个交互式工具，
    用户可以通过下列按键控制它：</p><div class="variablelist"><dl class="variablelist"><dt id="h"><span class="term"><span class="keycap"><strong>h</strong></span></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#h">¶</a></dt><dd><p>显示简短的帮助信息</p></dd><dt id=""><span class="term"><span class="keycap"><strong>Space</strong></span></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#">¶</a></dt><dd><p>立即刷新</p></dd><dt id="q"><span class="term"><span class="keycap"><strong>q</strong></span></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#q">¶</a></dt><dd><p>退出</p></dd><dt id="p"><span class="term"><span class="keycap"><strong>p</strong></span>, </span><span class="term"><span class="keycap"><strong>t</strong></span>, </span><span class="term"><span class="keycap"><strong>c</strong></span>, </span><span class="term"><span class="keycap"><strong>m</strong></span>, </span><span class="term"><span class="keycap"><strong>i</strong></span></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#p">¶</a></dt><dd><p>分别按照：路径,
        任务数量, CPU占用, 内存占用, I/O负载 对控制组进行排序。
        此设置还可以通过
        <code class="option">--order=</code> 选项
        进行控制。</p></dd><dt id="%"><span class="term"><span class="keycap"><strong>%</strong></span></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#%">¶</a></dt><dd><p>在显示CPU占用的两种不同方式(总时长,百分比)之间切换。
        此设置还可以通过
        <code class="option">--cpu=</code> 选项进行控制。</p></dd><dt id="+"><span class="term"><span class="keycap"><strong>+</strong></span>, </span><span class="term"><span class="keycap"><strong>-</strong></span></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#+">¶</a></dt><dd><p>增加/减少每次刷新之间的时间间隔。
        此设置还可以通过
        <code class="option">--delay=</code> 选项
        进行控制。</p></dd><dt id="P"><span class="term"><span class="keycap"><strong>P</strong></span></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#P">¶</a></dt><dd><p>在统计全部任务、仅统计用户空间进程之间进行切换。
        此设置还可以通过
         <code class="option">-P</code> 选项
        进行控制。</p></dd><dt id="k"><span class="term"><span class="keycap"><strong>k</strong></span></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#k">¶</a></dt><dd><p>在统计全部任务、仅统计用户空间进程与内核线程之间进行切换。
        此设置还可以通过
         <code class="option">-k</code> 选项
        进行控制。</p></dd><dt id="r"><span class="term"><span class="keycap"><strong>r</strong></span></span><a class="headerlink" title="Permalink to this term" href="systemd-cgtop.html#r">¶</a></dt><dd><p>在两种统计控制组内进程数量的方式上进行切换：
        (1)递归的包含子控制组内的进程；(2)不包含任何子控制组内的进程。
        此设置还可以通过
        <code class="option">--recursive=</code> 选项进行控制。
        当统计所有任务时，此按键不可用。
        此按键仅用于进程的统计(也就是
        <span class="keycap"><strong>P</strong></span> 或 <span class="keycap"><strong>k</strong></span>
        按键)。</p></dd></dl></div></div><div class="refsect1"><a name="id-1.8"></a><h2 id="退出状态">退出状态<a class="headerlink" title="Permalink to this headline" href="systemd-cgtop.html#%E9%80%80%E5%87%BA%E7%8A%B6%E6%80%81">¶</a></h2><p>返回值为 0 表示成功，
    非零返回值表示失败代码。</p></div><div class="refsect1"><a name="id-1.9"></a><h2 id="参见">参见<a class="headerlink" title="Permalink to this headline" href="systemd-cgtop.html#%E5%8F%82%E8%A7%81">¶</a></h2><p>
      <a href="systemd.html#"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
      <a href="systemctl.html#"><span class="citerefentry"><span class="refentrytitle">systemctl</span>(1)</span></a>,
      <a href="systemd-cgls.html#"><span class="citerefentry"><span class="refentrytitle">systemd-cgls</span>(1)</span></a>,
      <a href="systemd.resource-control.html#"><span class="citerefentry"><span class="refentrytitle">systemd.resource-control</span>(5)</span></a>,
      <a href="http://man7.org/linux/man-pages/man1/top.1.html"><span class="citerefentry"><span class="refentrytitle">top</span>(1)</span></a>
    </p></div></div></body></html>
